

           ███████  ███████  ███  ██████   ███  ███████
           █░░░░░█░  █░░░░█░  █░░ █░░░░█░   █░░ █░░█░░█░
           █░    █░  █░   █░  █░  █░    ░   █░   ░ █░  ░
           █░    █░  █░   █░  █░  █░  ███   █░     █░
           █░    █░  █░   █░  █░  █░   █░░  █░     █░
           █░  █ █░  █░   █░  █░  █░   █░   █░     █░
           ███████░ ███████░ ███  ██████░  ███    ███
            ░░░░█░░  ░░░░░░░  ░░░  ░░░░░░   ░░░    ░░░
                 █
                  ░  Copyright (C) 1992-94  P.C. Jahans

      An easy-to-use program for digitizing geological contacts
   and structures, outcrops, contours, etc. Output is placed in
   ASCII files which can be viewed on screen or sent to a printer.

      QDigit is completely menu-driven and features context-
   sensitive help -- there is no need for a manual. Just press
   <F1> at any time for relevent information. You may, however,
   need to refer to your digitizer manual to correctly configure
   QDigit before use.  Other features include full mouse support
   (although a mouse is not necessary), high speed data capture,
   and automatic saving of your configuration setup and
   calibration parameters.

      QDigit uses an affine transform to convert between map
   (world) and digitizer coordinates producing accurate results
   even from distorted maps or cross-sections (those which are
   not quite rectangular but more like irregular quadrilaterals).
   Such maps can result when the paper they are printed on is
   handled, folded, or soaked by rain.

      QDigit may be freely distributed and you are encouraged to
   do so.  Individuals, students and educational institutions may
   licence one copy free of charge.  If more than one copy is
   required, or if the program is used in a professional or
   commercial environment, a fee payment is required after a 30-
   day trial period as follows:

      Individuals, educational institutions:
                        Free     for the first copy
                        $25      for extra copies

      Industry:         $50      for the first copy
                        $25      for additional copies

   Payment may be made in US or Canadian dollars in the form of a
   cheque or money order addressed to the author at the address
   below.  Please do not send cash.  Bug reports, suggestions are
   welcome.


                           Peter C. Jahans
                        Department of Geology
                        University of Alberta
                     Edmonton, Alberta  T6G 2E3

             Copyright (C) 1992, 1993, 1994  P.C. Jahans
                        All rights reserved.



1023     hcHistList        = $03FF;

   History Lists▐
    ▀▀▀▀▀▀▀▀▀▀▀▀▀
      This is a list of previous choices in this category. You
   may select from this list as a shortcut to typing in the
   selection again. This feature is most useful when similar data
   is used repeatedly. Hit the <Enter> key to accept a
   highlighted selection or double-click on it with the mouse
   cursor. To cancel, click on the close button (upper left
   corner) or hit <Esc> to close history window.



1296     hcFileView        = $0510;

   File Viewer▐
    ▀▀▀▀▀▀▀▀▀▀▀
      You can view any text file in a scrolling window, and may
   view more than one file at a time by selecting this option
   repeatedly. Only the first 64k bytes or so of a file can be
   displayed in the viewer.



1312     hcFilePrint       = $0520;

   File Printing▐
    ▀▀▀▀▀▀▀▀▀▀▀▀▀
      Files can be sent to the printer using this option. The
   printer port is configured under Settings/Printer.



1344     hcDosShell        = $0540;

   DOS Shell▐
    ▀▀▀▀▀▀▀▀▀
      You may temporarily suspend QDigit to execute DOS commands
   and return to exactly where you left. To return, just type
   EXIT at the DOS prompt.



1360     hcTile            = $0550;

   Window Tiling▐
    ▀▀▀▀▀▀▀▀▀▀▀▀▀
      When multiple file viewing windows are on the screen, they
   may be tiled for simultaneous viewing. Each window is sized so
   that altogether they fill the area of the screen's "desktop".



1376     hcCascade         = $0560;

   Window Cascading▐
    ▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀
      When multiple file viewing windows are on the screen, they
   may be cascaded or stacked like a deck of cards for individual
   viewing, leaving only the top and left frame segments of the
   covered windows visible. By clicking the mouse cursor on the
   frame top, or using the function keys, windows may be brought
   to the top of the stack and moved around the screen.



1536     hcStartSubMenus   = $0600;

      Select this option to view a sub-menu list.



1945     hcBanner          = $0799;

   Billboard▐
    ▀▀▀▀▀▀▀▀▀
      Introductory banner with author name and copyright notice.



2201     hcHelp            = $0899;

   Help▐
    ▀▀▀▀
      Use the <F1> hot-key to obtain context sensitive help at
   any time. The help system always knows which part of the
   program is in use and brings up appropriate information to
   assist the user.



2457     hcQuit            = $0999;

   Terminate Program▐
    ▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀
      Exit QDigit. You can also exit quickly using the hot-key
   combination: <Alt X>



4368     hcComSettings     = $1110;

   Communications▐
    ▀▀▀▀▀▀▀▀▀▀▀▀▀▀
      These communications protocols must be set so that the
   digitizer can "talk" to the computer properly. Choose the COM
   port which is connected to the digitizer and set the other
   parameters according to your digitizer's manual. For example,
   a Summagraphics tablet typically requires the following setup:

                          Baud Rate -- 9600
                          Parity    -- EVEN
                          Data Bits -- 7
                          Stop Bits -- 2



4384     hcSetDataType     = $1120;

   Data Format▐
    ▀▀▀▀▀▀▀▀▀▀▀
      This is the format of the signals sent from your digitizer
   to the computer. Consult your digitizer's manual to determine
   which format is used. If your digitizing tablet outputs data
   using ASCII format make certain of the positions of characters
   and lengths of numeric fields. For example, a Summagraphics
   tablet typically uses an ASCII format as follows:

                         Button Position -- 2
          X Coordinate Starting Position -- 3, Length -- 6
          Y Coordinate Starting Position -- 9, Length -- 6



4400     hcCalibrate       = $1130;

   Calibrate Map▐
    ▀▀▀▀▀▀▀▀▀▀▀▀▀
      The digitizer needs to be calibrated to the coordinates of
   your map (world coordinates) before digitizing commences.
   Select X, Y or longitude/latitude coordinates then digitize
   four known points on your map. Units do not matter, just enter
   the known values when QDigit requests. Geographic coordinates
   are displayed in the order longitude, latitude. When
   calibration is complete, all coordinates are displayed as map
   (world) coordinates. You may optionally calibrate north for
   use when digitizing outcrops.



4432     hcCalibrateN      = $1150;

   Calibrate North▐
    ▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀
      When digitizing outcrops, the true direction of north must
   be provided so that dip directions may be accurately calcula-
   ted. First digitize a point near the northern end of a line
   parallel to north, then digitize a point near the southern
   end. This calibration is not necessary if outcrops will not be
   digitized.



4448     hcSetParaPort     = $1160;

   Printer Port▐
    ▀▀▀▀▀▀▀▀▀▀▀▀
      Indicate the port to which printer is attached.



4464     hcReadDefaults    = $1170;

   Load a Configuration File▐
    ▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀
      Upon startup, QDigit first looks for the default config-
   uration file (usually QDIGIT.DEF) in the current directory. If
   one isn't found there, the directory in which QDigit resides
   is then searched. If a configuration file is found, parameters
   specifying calibration values, I/O ports used, communication
   settings, etc., stored in the file will be automatically used
   to configure QDigit. Any configuration file, including those
   created using the Setup/Save Setup menu option, may also be
   loaded at any time. This can be very useful for digitizing
   several small maps or logs at one time, and also if an error
   was made while reconfiguring some parameter and the original
   value was lost.

      The command-line option, /C <filename>, where <filename> is
   the name of a default configuration file (without the angle
   brackets), allows the automatic loading of a user-specified
   configuration at program startup.



4480     hcSaveDefaults    = $1180;

   Save a Configuration File▐
    ▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀
      Selecting this option will manually save your current setup
   information such calibration values, communications settings
   ports in use, etc., in a file chosen by the user. Although
   these items are saved automatically when the QDigit is
   terminated, manually saving a configuration is recommended
   after calibration or setup and especially before altering any
   parameters for which the consequences are unknown. Your saved
   configuration can be reloaded at any time using the Setup/Load
   Setup menu option.



4496     hcResetDefaults   = $1190;

   Reset Configuration▐
    ▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀
      Selectively reset configuration parameters to system
   defaults. Resetting calibration allows the use of digitizer
   coordinates instead of map coordinates.

      If any "Advanced" configuration parameters are reset (such
   as communication settings and/or data format) you may have to
   refer to your digitizer manual to reconfigure the program. If
   you reset the advanced parameters and immediately save your
   setup, the configuration file will likely contain improper
   information upon subsequent startups but QDigit will not give
   a warning.



4512     hcSetPrecision    = $11A0;

   Set Output Data Precision▐
    ▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀
      The start of each line of data output by the digitizer is
   either a map coordinate pair or the depth and value of a log.
   The representation of these data are visible at the top left
   corner of the screen. You can alter the way these data appear
   on the screen and in the output file by setting the WIDTH and
   PRECISION parameters.

      WIDTH must be between 1 and 12, and PRECISION must be
   between 0 and WIDTH-2. These settings should also match the
   values of the actual data or output representation may be
   unpredictable or incorrect. For instance, don't specify a
   width of 4 to display coordinate values like 6543117.50.


     Examples:  334.2837  results from WIDTH = 8, PRECISION = 4
                334.3     results from WIDTH = 5, PRECISION = 1



4608     hcNotInitialized  = $1200;

   Program Not Initialized▐
    ▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀
      Upon startup, QDigit first looks for the default config-
   uration file (usually QDIGIT.DEF) in the current directory.
   If one isn't found there, the directory in which QDigit
   resides is then searched. If still no file is found and none
   was specified on the command line using the /C <filename>
   option, QDigit starts up in an uninitialized state and must be
   configured to your digitizer using the Setup/Advanced/Comm
   Settings and Setup/Advanced/Data Format menu options. You may
   need to refer to your digitizer manual to correctly configure
   QDigit before use.



4624     hcDigitizePoints  = $1210;

   Digitizing Points▐
    ▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀
      This is a generic point digitizing procedure. Only X, Y or
   lon/lat coordinates will be saved in the output file.



4640     hcDigitizeLines   = $1220;

   Digitizing Lines▐
    ▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀
      This is a generic line digitizing procedure. Only X, Y or
   lon/lat coordinates will be saved in the output file.



4656     hcDigitizeWells   = $1230;

   Digitizing Wells▐
    ▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀
      X, Y or lon/lat coordinates plus any additional specified
   information (kb elevation, well name, total depth, etc.) will
   be saved in the output file. This option can of course also be
   used to store any kind of data pertaining to digitized point
   coordinates.



4672     hcDigitizeCntrs   = $1240;

   Digitizing Contours▐
    ▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀
      X, Y or lon/lat coordinates of lines and the corresponding
   specified constant elevation will be saved in the output file.



4688     hcDigitizeOCrops  = $1250;

   Digitizing Outcrops▐
    ▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀
      X, Y or lon/lat coordinates and dip direction will be
   calculated for each digitized outcrop. These data plus
   additional information such as dip, elevation, etc. will be
   saved in the output file.



4704     hcPositionOCrops  = $1260;

   Positioning Outcrops▐
    ▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀
      Use the digitizer to find the precise coordinates of an
   outcrop as you draft them onto a map. X, Y or lon/lat
   coordinates plus any additional specified information
   (elevation, dip direction & dip, etc.) will be saved in the
   output file.



8192     hcOkBox           = $2000;

   Dialog Box▐
    ▀▀▀▀▀▀▀▀▀▀
      This window is known as a dialog box. It may contain input
   controls such as editing fields, check-boxes and radio
   buttons. Editing fields are used to type in appropriate text,
   checkboxes for selecting one or more options and radio buttons
   for choosing one unique option. There is full mouse and/or
   keyboard support. Hit Ok or the <F9> key to accept what is
   displayed, Cancel or the <Esc> key to abort. Any highlighted
   text in an input field is immediately replaced by most
   keystrokes. The exceptions are when an arrow key or the insert
   or backspaces are pressed.



8208     hcFileListBox     = $2010;

   File List Window▐
    ▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀
      Select from the list, or type into the input field the name
   of the file desired. When the cursor resides in the list,
   typing the first letters of the filename will cause the cursor
   to jump to the first names starting with those letters. File
   information is shown at the bottom of the window.



8224     hcMessageBox      = $2020;

   Message Window▐
    ▀▀▀▀▀▀▀▀▀▀▀▀▀▀
      You may respond to the message contained in this window by
   clicking on a button or you may cancel and remove the window
   by hitting the <Esc> key.



8448     hcCalibrateBox    = $2100;

      The digitizer is waiting for your actions here: press the
   digitizer mouse button to register points. To backtrack or
   abort, click on the close button (upper left corner of the
   window), or hit the <Esc> key.



8464     hcCalibrateNBox   = $2110;

      The digitizer is waiting for your actions here: press the
   digitizer mouse button to register points. To backtrack or
   abort, click on the close button (upper left corner of the
   window), or hit the <Esc> key.



8704     hcDigWindow       = $2200;

      The digitizer is waiting for your actions here: press the
   digitizer mouse button to register points. To indicate when
   you are finished, click on the close button (upper left corner
   of the window), or hit the <F3> or the <Esc> key.



8720     hcPointDigWindow  = $2210;

      The digitizer is waiting for your actions here: press the
   digitizer mouse button to register points. To indicate when
   you are finished, click on the close button (upper left corner
   of the window), or hit the <F3> or the <Esc> key.



8736     hcLineDigWindow   = $2220;

      The digitizer is waiting for your actions here: press the
   digitizer mouse button to register points. To indicate when
   you are finished, click on the close button (upper left corner
   of the window), or hit the <F3> or the <Esc> key.



8752     hcWellDigWindow   = $2230;

      The digitizer is waiting for your actions here: press the
   digitizer mouse button to register points. To indicate when
   you are finished, click on the close button (upper left corner
   of the window), or hit the <F3> or the <Esc> key.



8768     hcCntrDigWindow   = $2240;

      The digitizer is waiting for your actions here: press the
   digitizer mouse button to register points. To indicate when
   you are finished, click on the close button (upper left corner
   of the window), or hit the <F3> or the <Esc> key.



8784     hcOCDigWindow     = $2250;

      The digitizer is waiting for your actions here: press the
   digitizer mouse button to register points. To indicate when
   you are finished, click on the close button (upper left corner
   of the window), or hit the <F3> or the <Esc> key.



8800     hcOCPosWindow     = $2260;

      The digitizer is waiting for your actions here: press the
   digitizer mouse button to register points. To indicate when
   you are finished, click on the close button (upper left corner
   of the window), or hit the <F3> or the <Esc> key.



8816     hcCntrDatWindow   = $2270;

   Elevation Data▐
    ▀▀▀▀▀▀▀▀▀▀▀▀▀▀
      Enter the elevation value for the contour you are about to
   digitize. This value will be saved with every X, Y or lon/lat
   coordinate in the specified file.



8992     hcFileViewer      = $2320;

   File Viewing Window▐
    ▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀
      This window displays the file you select for viewing. It
   can be scrolled up or down and left or right if required, can
   be moved, zoomed and resized, and cascaded or tiled with other
   viewing windows. Either the mouse or the keyboard can facili-
   tate these tasks -- check the status line for command hints.
   To move the window via the keyboard, hit <Ctrl F5> then the
   arrow keys, or, using the mouse, click and hold on the top
   border of the window and drag it. To resize the window via the
   keyboard, hit <Ctrl F5> as before, then use the shifted arrow
   keys, or, with the mouse, click on the lower right corner of
   the window and drag it.



